DNS and WINS

Functions
void	cmDnsSetServersA (const NQ_CHAR *servers)
void	cmDnsSetServers (const NQ_WCHAR *servers)
NQ_IPADDRESS *	cmDnsGetServer (NQ_COUNT dnsID)
NQ_COUNT	cmDnsGetNumDnsServers (void)
void	cmNetBiosSetWinsA (const NQ_CHAR *servers)
void	cmNetBiosSetWins (const NQ_WCHAR *servers)
NQ_IPADDRESS4	cmNetBiosGetWins (NQ_COUNT winsID)
NQ_COUNT	cmNetBiosGetNumWinsServers (void)
NQ_STATUS	cmDnsSetDomainA (const NQ_CHAR *domainName)
NQ_STATUS	cmDnsSetDomain (const NQ_WCHAR *domainName)

Detailed Description

Function Documentation

void cmDnsSetServersA

(

const NQ_CHAR *

servers

)

After startup NQ uses the list of DNS servers as defined in the NQ configuration. By calling this function application replaces the initial list with a new one.

Parameters

servers

Pointer to the new list of DNS servers. This list is a string of IP addresses, delimited by a semicolon. Each address may have a form of IPv4 or IPv6 address. This pointer can be NULL. In this case NQ will not query DNS servers.

Note

This is an ASCII version of cmDnsSetServers()

void cmDnsSetServers

(

const NQ_WCHAR *

servers

)

After startup NQ uses the list of DNS servers as defined in the NQ configuration. By calling this function application replaces the initial list with a new one.

Parameters

servers

Pointer to the new list of DNS servers. This list is a string of IP addresses, delimited by a semicolon. Each address may have a form of IPv4 or IPv6 address. This pointer can be NULL. In this case NQ will not query DNS servers.

NQ_IPADDRESS* cmDnsGetServer

(

NQ_COUNT

dnsID

)

After startup NQ uses the DNS servers as defined in the NQ configuration or by calling cmDnsSetServersA() or cmDnsSetServers(). By calling this function with a specific DNS index application returns the specific DNS address.

Parameters

dnsID

DNS server index.

Returns

the pointer of the ip address of the specific DNS server or 0.

Note

The pointer should be used as NQ_IPADDRESS4 or NQ_IPADDRESS6 depends on the current system configurations.

NQ_COUNT cmDnsGetNumDnsServers

(

void

)

After startup NQ uses the DNS servers as defined in the NQ configuration or by calling cmDnsSetServersA() or cmDnsSetServers(). By calling this function application returns the number of current defined DNS addresses.

Returns

Number of defined DNS addresses

void cmNetBiosSetWinsA

(

const NQ_CHAR *

servers

)

After startup NQ uses the WINS IP as defined in the NQ configuration. By calling this function application replaces the initial WINS with a list of new ones.

Parameters

servers

Pointer to the list of new WINS servers. This list is a string of IP addresses, delimited by a semicolon. Each address should have a form of IPv4 address. This pointer can be NULL, in this case NQ will not query WINS.

Note

• WINS addresses set over this function affect only name-to-IP and IP-to-name resolution. They do not affect name registration, which is always performed against the default WINS. We assume that in a case of multiple WINS they replicate name registered in just one of them.
• This is an ASCII version of cmNetBiosSetWins()

void cmNetBiosSetWins

(

const NQ_WCHAR *

servers

)

After startup NQ uses the WINS IP as defined in the NQ configuration. By calling this function application replaces the initial WINS with a list of new ones.

Parameters

servers

Pointer to the list of new WINS servers. This list is a string of IP addresses, delimited by a semicolon. Each address should have a form of IPv4 address. This pointer can be NULL, in this case NQ will not query WINS.

Note

WINS addresses set over this function affect only name-to-IP and IP-to-name resolution. They do not affect name registration, which is always performed against the default WINS. We assume that in a case of multiple WINS they replicate name registered in just one of them.

NQ_IPADDRESS4 cmNetBiosGetWins

(

NQ_COUNT

winsID

)

After startup NQ uses the WINS servers as defined in the NQ configuration or by calling cmNetBiosSetWinsA() or cmNetBiosSetWins(). By calling this function with a specific WINS index application returns the specific WINS address.

Parameters

winsID

WINS server index.

Returns

the IPV4 address of the specific WINS server or 0.

NQ_COUNT cmNetBiosGetNumWinsServers

(

void

)

After startup NQ uses the WINS servers as defined in the NQ configuration or by calling cmNetBiosSetWinsA() or cmNetBiosSetWins(). By calling this function application returns the number of current defined WINS addresses.

Returns

Number of defined WINS addresses

NQ_STATUS cmDnsSetDomainA

(

const NQ_CHAR *

domainName

)

After startup NQ uses the domain name as defined in the NQ configuration. By calling this function application replaces the initial domain name with a new ones. This name becomes available for subsequent operations.

Parameters

domainName

New domain name. It should contain more than one symbol and it should not be longer than UD_NQ_HOSTNAMESIZE

Returns

NQ_SUCCESS on success or NQ_FAIL when the domain name is NULL or it is too long or too short.

Note

This is an ASCII version of cmDnsSetDomain()

NQ_STATUS cmDnsSetDomain

(

const NQ_WCHAR *

domainName

)

After startup NQ uses the domain name as defined in the NQ configuration. By calling this function application replaces the initial domain name with a new ones.

This name becomes available for subsequent operations.

Parameters

domainName

New domain name. It should contain more than one symbol and it should not be longer than UD_NQ_HOSTNAMESIZE

Returns

NQ_SUCCESS on success or NQ_FAIL when the domain name is NULL or it is too long or too short.